/*
 *英才会硕信息科技有限公司拥有本软件的版权，拥有本软件版权2025   并保留所有权利。
 *Copyright 2021,YCHS Information&Science Technology Co.,Ltd,
 *All rights reserved.
 */
package com.ychs.lawyerback01.service;

import com.ychs.lawyerback01.dto.SealQueryDTO;
import com.ychs.lawyerback01.pojo.SealRecord;
import jakarta.servlet.http.HttpServletResponse;


import java.io.IOException;
import java.util.Map;

/**
 * @author xuehongjin
 * @version 1.0
 * @date 2025/8/28
 */
public interface SealRecordService {

    /**
     * 新增印章使用记录
     * @param sealRecord 印章记录对象
     * @param username 操作人
     * @return 新增的印章记录
     */
    SealRecord addSealRecord(SealRecord sealRecord, String username);

    /**
     * 更新印章使用记录
     * @param id 记录ID
     * @param sealRecord 印章记录对象
     * @param username 操作人
     * @return 更新后的印章记录
     */
    SealRecord updateSealRecord(Long id, SealRecord sealRecord, String username);

    /**
     * 根据ID删除印章记录
     * @param id 记录ID
     */
    void deleteSealRecord(Long id);

    /**
     * 根据ID查询印章记录
     * @param id 记录ID
     * @return 印章记录对象
     */
    SealRecord getSealRecordById(Long id);

    /**
     * 分页查询印章记录
     * @param queryDTO 查询条件
     * @return 分页查询结果
     */
    Map<String, Object> getSealRecordsByPage(SealQueryDTO queryDTO);



    /**
     * 导出印章记录为Excel
     * @param queryDTO 查询条件
     * @param response 响应对象
     */
    void exportExcel(SealQueryDTO queryDTO, HttpServletResponse response) throws IOException;

}
